home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / lib / perl5 / Gnome2 / AppHelper.pod < prev    next >
Encoding:
Text File  |  2006-06-19  |  2.5 KB  |  178 lines

  1. =head1 NAME
  2.  
  3. Gnome2::AppHelper
  4.  
  5. =for object Gnome2::AppHelper
  6.  
  7. =for apidoc
  8.  
  9. =head1 GnomeUIInfo
  10.  
  11. In Gnome2 GnomeUIInfo's are often used as a convenient way to create GUI's.  In
  12. Perl, GnomeUIInfo's are always references to arrays of items.  Items can either
  13. be references to hashs or references to arrays:
  14.  
  15. =over
  16.  
  17. =item Hash Reference
  18.  
  19. When using hash references, items are specified by giving key-value pairs.  A
  20. typical example:
  21.  
  22.   { type => "item", label => "Quit", callback => sub { exit(0); } }
  23.  
  24. For the list of valid keys, see below.
  25.  
  26. =item Array References
  27.  
  28. When using array references, items are a list of the following keys, in this
  29. order:
  30.  
  31.   type,
  32.   label,
  33.   hint,
  34.   moreinfo,
  35.   pixmap_type,
  36.   pixmap_info,
  37.   accelerator_key and
  38.   modifiers.
  39.  
  40. The example from above would become:
  41.  
  42.   [ "item", "Item", undef, sub { exit(0); },
  43.     undef, undef, undef, undef ]
  44.  
  45. =back
  46.  
  47. To create multi-level structures, you use the "subtree" type and the "subtree"
  48. key, as in the following example:
  49.  
  50.   {
  51.     type => "subtree",
  52.     label => "Radio Items",
  53.     subtree => [
  54.       {
  55.         type => "radioitems",
  56.         moreinfo => [
  57.           {
  58.             type => "item",
  59.             label => "A"
  60.           },
  61.           {
  62.             type => "item",
  63.             label => "B"
  64.           },
  65.           {
  66.             type => "item",
  67.             label => "C"
  68.           },
  69.           {
  70.             type => "item",
  71.             label => "D"
  72.           },
  73.           {
  74.             type => "item",
  75.             label => "E"
  76.           }
  77.         ]
  78.       }
  79.     ]
  80.   }
  81.  
  82. =cut
  83.  
  84. =for object Gnome2::AppHelper
  85. =cut
  86.  
  87. =for object Gnome2::AppHelper
  88. =cut
  89.  
  90. =for object Gnome2::AppHelper
  91. =cut
  92.  
  93.  
  94.  
  95.  
  96. =head1 METHODS
  97.  
  98. =head2 Gnome2-E<gt>B<accelerators_sync> 
  99.  
  100. =over
  101.  
  102. =back
  103.  
  104. =head2 $menu_shell-E<gt>B<fill_menu> ($uiinfo, $accel_group, $uline_accels, $pos)
  105.  
  106. =over
  107.  
  108. =over
  109.  
  110. =item * $uiinfo (Gnome2::UIInfo) 
  111.  
  112. =item * $accel_group (Gtk2::AccelGroup) 
  113.  
  114. =item * $uline_accels (boolean) 
  115.  
  116. =item * $pos (integer) 
  117.  
  118. =back
  119.  
  120. =back
  121.  
  122. =head2 $toolbar-E<gt>B<fill_toolbar> ($uiinfo, $accel_group)
  123.  
  124. =over
  125.  
  126. =over
  127.  
  128. =item * $uiinfo (Gnome2::UIInfo) 
  129.  
  130. =item * $accel_group (Gtk2::AccelGroup) 
  131.  
  132. =back
  133.  
  134. =back
  135.  
  136. =head2 list = $parent-E<gt>B<find_menu_pos> ($path)
  137.  
  138. =over
  139.  
  140. =over
  141.  
  142. =item * $path (string) 
  143.  
  144. =back
  145.  
  146.  
  147. Returns the GtkWidget and the position associated with the path.
  148.  
  149.  
  150. =back
  151.  
  152. =head2 $bar-E<gt>B<install_menu_hints> ($uiinfo)
  153.  
  154. =over
  155.  
  156. =over
  157.  
  158. =item * $uiinfo (Gnome2::UIInfo) 
  159.  
  160. =back
  161.  
  162. =back
  163.  
  164.  
  165. =head1 SEE ALSO
  166.  
  167. L<Gnome2>
  168.  
  169. =head1 COPYRIGHT
  170.  
  171. Copyright (C) 2003-2004 by the gtk2-perl team.
  172.  
  173. This software is licensed under the LGPL.  See L<Gnome2> for a full notice.
  174.  
  175.  
  176. =cut
  177.  
  178.